VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam
0.1.0 - STU1 Draft
VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam
0.1.0 - STU1 Draft
VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Official URL: http://fhir.hl7.org.vn/core/ImplementationGuide/hl7.fhir.vn.core | Version: 0.1.0 | |||
| Draft as of 2026-03-21 | Computable Name: VNCoreIG | |||
Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam — Phiên bản 0.1.0
Lưu ý: Đây là bản dự thảo do cộng đồng xây dựng. Bộ Hướng dẫn này chưa được cơ quan nhà nước phê duyệt hoặc ban hành chính thức. Nội dung mang tính tham khảo kỹ thuật.
VN Core FHIR Implementation Guide (IG) xác định bộ hồ sơ (profiles), phần mở rộng (extensions), bộ thuật ngữ (terminology), và hệ thống định danh (naming systems) cốt lõi cho việc trao đổi dữ liệu y tế tại Việt Nam theo tiêu chuẩn HL7 FHIR R4 (4.0.1).
Phiên bản này tập trung vào các artifact P0 (ưu tiên cao nhất), bao gồm:
| Loại artifact | Số lượng | Mô tả |
|---|---|---|
| Profiles | 23 | Patient, Practitioner, PractitionerRole, Organization, Address, Encounter, Condition, Observation (3: Lab, VitalSigns, YHCT), AllergyIntolerance, Procedure, MedicationRequest, ServiceRequest, Coverage, Claim, ClaimResponse, ExplanationOfBenefit, DocumentReference, DiagnosticReport, Medication, Device, DeviceUseStatement |
| Extensions | 20 | Dân tộc, tôn giáo, nghề nghiệp, tỉnh/thành, xã/phường, thẻ BHYT, nơi ĐKKCB, loại KCB BHYT, kết quả điều trị, hạng BV, tuyến KCB, loại hình CSKCB, chi phí BHYT (3), thanh toán (2), khoa chỉ định, ngày y lệnh, phạm vi BH TBYT |
| CodeSystems | 42 | 17 quốc gia + 5 quốc tế bản địa hóa + 10 YHCT + 1 nghề nghiệp VSCO + 2 nhân viên y tế + 7 bảo hiểm/thanh toán |
| ValueSets | 43 | Tương ứng cho mỗi CodeSystem |
| SearchParameters | 7 | CCCD, BHYT, CCHN, CSKCB, MALYDO, ICD-10, thẻ BHYT |
| ConceptMaps | 1 | CLS VN → LOINC (2.964 chỉ số, 100% coverage) |
| NamingSystems | 5 | CCCD, BHYT, CCHN, CSKCB, MRN |
| CapabilityStatement | 1 | VNCoreServer — khả năng tối thiểu FHIR server |
| Examples | 33 | Ít nhất 1 ví dụ cho mỗi profile |
Đây là bản STU1 Draft (Standard for Trial Use). Cộng đồng y tế số Việt Nam được khuyến khích sử dụng thử nghiệm, phản hồi và đóng góp qua email info@hl7.org.vn.
| Phiên bản | Thời gian dự kiến | Nội dung chính |
|---|---|---|
| v0.2.0 | Q3/2026 | Profiles bổ sung: MedicationDispense, Composition, Specimen, ImagingStudy, Location. ConceptMap XML 4210 → FHIR. Bộ conformance testing cơ bản |
| v0.3.0 | Q1/2027 | Consent profile (tuân thủ Luật 91/2025), OperationDefinition, Bundle profiles, hỗ trợ SMART-on-FHIR và Bulk Data |
| v1.0.0 | Q3/2027 | Phiên bản chính thức sau quy trình ballot. Yêu cầu tối thiểu 3 implementation reports và conformance test suite hoàn chỉnh |
Omi HealthTech cam kết duy trì và phát triển VN Core FHIR IG lâu dài, phối hợp cùng các bên liên quan trong hệ sinh thái y tế số Việt Nam.
| Mục | Nội dung |
|---|---|
| Giới thiệu | Về Omi HealthTech, OmiGroup, và tầm nhìn VN Core |
| Bắt đầu nhanh | 4 bước để bắt đầu sử dụng VN Core FHIR IG |
| Cơ sở pháp lý | Bảng tổng hợp 27+ văn bản pháp lý ảnh hưởng đến thiết kế |
| Hướng dẫn chung | Quy tắc Must Support, xử lý tên tiếng Việt, backward-compatible |
| Hướng dẫn thuật ngữ | Cách sử dụng CodeSystem/ValueSet, binding strength |
| Tình huống lâm sàng | Minh họa luồng dữ liệu thực tế (khám ngoại trú + BHYT) |
| Profiles | Danh sách 23 profiles với mô tả chi tiết |
| Extensions | Danh sách 20 extensions và ngữ cảnh sử dụng |
| Thuật ngữ | Danh sách 42 CodeSystems + 43 ValueSets |
| Bảo mật và Quyền riêng tư | Luật 91/2025, NĐ 356/2025, phân loại dữ liệu |
| Validation | Hướng dẫn validation 3 tầng |
| SNOMED CT VN — Đính chính | Đính chính bản dịch SNOMED CT tiếng Việt |
| Tải xuống | Package, definitions |
| Lịch sử thay đổi | Ghi chép phiên bản |
Bộ Hướng dẫn Triển khai này là sáng kiến của Omi HealthTech (một công ty thành viên thuộc OmiGroup), được xây dựng với mục đích đóng góp cho cộng đồng y tế số Việt Nam.
The VN Core FHIR Implementation Guide defines the foundational FHIR R4 profiles, extensions, terminology, and naming systems for healthcare data exchange in Vietnam. Version 0.1.0 provides 23 profiles, 20 extensions, 42 CodeSystems, 43 ValueSets, 7 SearchParameters, 1 ConceptMap (CLS VN → LOINC, 2,964 codes), 5 NamingSystems, 33 examples, and 1 CapabilityStatement. Profiles cover: Patient, Practitioner, PractitionerRole, Organization, Address, Encounter, Condition, Observation (Lab, VitalSigns, YHCT), AllergyIntolerance, Procedure, MedicationRequest, ServiceRequest, Coverage, Claim, ClaimResponse, ExplanationOfBenefit, DocumentReference, DiagnosticReport, Medication, Device, and DeviceUseStatement. The IG references 27+ Vietnamese legal documents and is designed to align with the 2025-2026 regulatory framework, including the Personal Data Protection Law (91/2025), EMR regulations (TT 13/2025), and the administrative restructuring from 63 to 34 provinces (NQ 202/2025). Implementers remain responsible for ensuring full legal compliance. This is a community-oriented draft initiated by Omi HealthTech (a member company of OmiGroup) as a contribution to Vietnam's digital healthcare ecosystem.